Developer Documentation

QuickTime 4 API Documentation

Wired Movies and Sprites

| Previous | Chapter Contents | Chapter Top | Next |

Sprite Track Property Atoms

The following section describes sprite track property atoms. Track property atoms are applied to the whole track, not just to a single sample. See "Authoring Wired Movies and Sprite Animations," for information on other track property atoms and how to add them to the sprite track's media.

Constant descriptions

kSpriteTrackPropertyHasActions
You must add an atom of this type with its leaf data set to true if you want the movie controller to execute the actions in your sprite track's media. The atom's leaf data is of type Boolean . The default value is false , so it is very important to add an atom of this type if you want interactivity to take place.

kSpriteTrackPropertyQTIdleEventsFrequency
You must add an atom of this type if you want the Sprites in your sprite track to receive kQTEventIdle QuickTime events. The atom's leaf data is of type UInt32 . The value is the mimimum number of ticks that must pass before the next QTIdle event is sent . Each tick is 1/60th of one second. To specify "Idle as fast as possible," set the value to 0. The default value is kNoQTIdleEvents which means don't send any idle events.

It is possible that for small idle event frequencies, the movie will not be able to keep up, in which case they will be sent as fast as possible.

Since sending idle events takes up some time, it is best to specify the largest frequency that produces the results that you desire, or kNoQTIdleEvents if you do not need them.

kSpriteTrackPropertyVisible
You may cause the entire sprite track to be invisible by setting the value of this Boolean property to false . This is useful for using a sprite track as a hidden button track--for example, placing an invisible sprite track over a Video Track would allow the characters in the video to be clicked on. The default value is visible ( true ).

kSpriteTrackPropertyScaleSpritesToScaleWorld
You may cause each sprite to be rescaled when the sprite track is resized by setting the value of this Boolean property to true . Setting this property can improve the drawing performance and quality of a scaled sprite track. This is particularly useful for sprite images compressed with codecs which are resolution-independent, such as the Curve codec. The default value for this property is false .


© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |